home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / dfÜ / crashmail / areafixhelp.doc < prev    next >
Encoding:
Text File  |  1995-11-02  |  4.5 KB  |  130 lines
  1.  
  2.             Description of CrashMail's built-in AreaFix
  3.             ===========================================
  4.  
  5. What is AreaFix?
  6. ----------------
  7. AreaFix is a feature present at most FidoNet nodes, either built-in in
  8. the tosser or as a stand-alone program. AreaFix allows you to connect
  9. and disconnect to echomail areas, change your password and change some
  10. other things in your configuration without asking your feed/boss to do
  11. it for you.
  12.  
  13. How do I use AreaFix?
  14. ---------------------
  15. You communicate with AreaFix using netmail messages. The message header
  16. of a message to AreaFix should look like this:
  17.  
  18. From: Johan Billing
  19.   To: AreaFix
  20. Subj: <password> [<switches>]
  21.  
  22. <AreaFix commands>
  23. ...
  24. ---
  25.  
  26. <Password> is your private AreaFix password that you need to make sure
  27. that nobody else alters your configuration. Your AreaFix password is
  28. assigned by your boss/feed, so you may have to ask him about a password.
  29.  
  30. [<switches>] are extra commands that you can send to AreaFix. Currently
  31. there is only one switch:
  32.  
  33.  -l or -q         Send list of all areas
  34.  
  35. This switch is only here to be compatible with other AreaFix programs.
  36. It is recommended that you use the %-commands described later instead.
  37.  
  38. "---" marks the end of an AreaFix message.
  39.  
  40. NOTE: The name doesn't necessarily has to be AreaFix, your boss may have
  41. configured CrashMail to use other names instead.
  42.  
  43. What commands can I put in the text?
  44. ------------------------------------
  45.  
  46. Change connected areas:
  47.  
  48. [+]areaname[,R=<max>]   Connect to an area. The '+' is optional. If
  49.                         the R option is specified after the area,
  50.                         that number of old messages in the area will
  51.                         be rescanned and sent to you.
  52.  
  53. -areaname               Disconnect from an area
  54.  
  55. =areaname[,R=<max>]     Update an area. This is useful if you want to
  56.                         rescan an area you are already connected to.
  57.  
  58. Special commands
  59.  
  60. %HELP                   Send this text
  61.  
  62. %LIST                   Send list of all areas
  63. %QUERY                  Send list of all linked areas
  64. %UNLINKED               Send list of all unlinked areas
  65.  
  66. %PAUSE                  Do not send any echomail until a %RESUME is sent
  67. %RESUME                 Send echomail again. These commands can be very
  68.                         handy if you are away for a few weeks and don't
  69.                         want to get any echomail.
  70.  
  71. %PWD <pw>               Changes your AreaFix password to the new password
  72.                         specified after the command.
  73.  
  74. %COMPRESS <name>        Changes the packer used to compress your mail to
  75.                         the packer specified after the command. Send
  76.                         "%COMPRESS ?" to get a list of packers.
  77.  
  78. %RESCAN                 All areas that are added or updated after this
  79.                         line will be rescanned, that is all old messages
  80.                         in those areas will be sent to you. This can be
  81.                         very dangerous since you don't know how many
  82.                         messages you will get, so in most cases, it is
  83.                         better to use the R option when adding/updating
  84.                         areas instead.
  85.  
  86. Examples:
  87. ---------
  88.  
  89. R20_TRASHCAN            Connect to R20_TRASHCAN
  90.  
  91. %LIST                   Send list of areas
  92.  
  93. R20_AMIGA,R=50          Connect to R20_AMIGA and get the last 50 messages
  94.                         in the area.
  95.  
  96. %PWD xyzzy              Change your AreaFix password to "xyzzy".
  97.  
  98. %COMPRESS ZIP           Change your compression method to ZIP.
  99.  
  100. %PAUSE                  Turn off echomail for a while
  101.  
  102. %RESUME                 Turn on echomail again
  103.  
  104. =R20_AMIGA,R=100        Get the last 100 messages in R20_AMIGA (if you are
  105.                         already connected to the area)
  106.  
  107. A few words on rescan
  108. ---------------------
  109. Messages that are rescanned won't look exactly like they originally did
  110. because of the way they are stored locally. Please think of that when
  111. reading them.
  112.  
  113. For example, these things can be changed:
  114.  
  115.   o The character set of the message may be changed. In some cases, the
  116.     original character set can be found in the "^a_CHRS" control line,
  117.     but not always.
  118.  
  119.   o The address in the Origin line may have a "@fidonet" or another
  120.     domain name added.
  121.  
  122.   o A program name may have been added after the tearline ("---").
  123.  
  124.   o All control lines ("kludges") are in the beginning of a message
  125.     regardless of where they originally were. This only happens if
  126.     your uplink uses a UMS messagebase.
  127.  
  128. You can easily tell if a message has been rescanned, just look for the
  129. ^aRESCANNED control line.
  130.